Display Parameters

Modules
	Display parameters: Graphics
	Display Parameters: View
	Display parameters: World
	Display parameters: Fibers
	Parameters of Play
	Display parameters: Points

Detailed Description

Display parameters can be embedded in the config file, in the display string of each object. A minimal list of parameters is given by play parameters. The display strings are ignored by sim.

Global Parameters

Global parameters are divided in three groups:

• World
• Graphics
• View
• Parameters of Play

They are all set in the simul object, for example:

set simul *
{
  ...
  display = ( delay=50; point_value=0.01; zoom=0.6; )
}

or alternatively:

set simul:display * ( back_color=blue )

Objects

Each class of object has its own display parameters (color, size, etc.), which should be specified within the 'set' command. Fibers use FiberDispPar:

set fiber filament
{
  ...
  display = ( line_width=3; color=blue; )
}

Most objects use PointDispPar:

set hand motor
{
  ...
  display = ( size=3; color=green; )
}

Alternative syntax:

set fiber:display microtubule
{
  line_width = 3
  color = blue
}

External setup files

Display parameters can also be specified in a separate file with extension .cms. Such setup file should be specified on the command line:

play display.cms live

It will be read before the simulation starts, and thus any value can be changed while cytosim reads config.cym.

To control at which time the display parameters are changed, the best technique is to include the setup in the main config file:

include ../display.cms { required=0 }

The result will be equivalent to having the specifications directly in the config file, except that cytosim will continue even if the setup file is not found (because 'required=0'). In this way, you can safely share a single display file for multiple simulations.

Colors

A color is composed of 4 components (Red, Green, Blue, Alpha), where the alpha value specifies transparency. Colors can be specified in different ways:

Syntax	Example	Note
0xRRGGBBAA 0xRRGGBB	0xFF0000FF	Component are specified with 2 hexadecimal bytes
(r g b a) (r g b)	(1 0 0.5)	Components are specified in floating points
COLOR_NAME	red	Cytosim has a list of common colors
#INTEGER	#12	Index in the list of known colors

Examples:

color = blue

Opaque red:

color = 0xFF0000FF

Transparent blue:

color = 0x0000FF88